home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Gfx / show / QLView.readme < prev    next >
Text File  |  2004-09-23  |  5KB  |  116 lines
  1. Short:    Sinclair QL Screen viewer and iff saver.
  2. Author:   Ventzislav Tzvetkov and Stefan A. Haubenthal
  3. Uploader: drHirudo@Amigascne.org (Ventzislav Tzvetkov) http://drhirudo.hit.bg
  4. Version:  25.08
  5. Type:     gfx/show
  6.  
  7.  
  8.  This little utility allows you to view raw Sinclair QL screen files on
  9. Amiga screen, and save them as  ILBM  images. Both  MODE 4  and  MODE 8
  10. screens  are  supported. Only  QL  standart  32768 bytes long files are
  11. recognized and shown.  On the  test  files  included  in  the  archive,
  12. comments are set for each picture,  suggesting  the  mode  for accurate
  13. viewing. The color palette is taken  from  Sinclair QL  screenshot, and
  14. believed to be as  much  accurate  as  possible.   QLView   saves   the
  15. shown picture in ILBM non compressed format,  24668  bytes  for  MODE 8 
  16. pictures and 49244 bytes for MODE 4 pictures,both with Depth 3 (8 Color
  17. Pallete).  Currently the program omits the flash  bits,  so some images
  18. doesn't look exactly the same as on real or emulated QL.
  19. Gwendoline_screen for example have some flashing snowflakes,  which are
  20. standing still on the QLView screen.
  21.  
  22.  
  23.  Usage:
  24.  
  25. From CLI> QLView [QLScreen] [MODE=4/8]  , where QLScreen is the file to
  26. be shown and MODE is the preffered mode (Default is 8).  Both arguments
  27. are not obligatory. Examples:
  28.    
  29.  > QLView Renault5_screen 4      , will show Renault5_screen in MODE 4.
  30.  > QLView Girl_screen MODE=4     , will show   Girl_screen   in MODE 4.
  31.  > QLView GChrome_screen         , will show GChrome_screen  in MODE 8.
  32.  > QLView           - Launches the program. Some help text will appear.
  33.  > QLView ?         - Shows Usage info.
  34.  > QLView MODE=4    - Launches the program in MODE 4.Help text appears.
  35.  
  36. From Workbench -> DoubleClick on the program icon.
  37.  
  38. On the program execution ->
  39.  
  40.   There is a menu accessable on right mouse click,  which  is  normally
  41. hidden for viewing purposes.
  42.  
  43.   "Open File" menu item or RightAmiga+O or O key - Opens  FileRequester
  44. which can select QL screen for load. QLView will render it immediately,
  45. if it is really a QL MODE 4 or MODE 8 picture.
  46.  
  47.   "Save as IFF" menu item or RightAmiga+S or S key -Opens FileRequester
  48. for choosing filename of the ILBM format image,  and  saves the current
  49. display with this name. If the filename already exist a  requester will 
  50. appear, giving the chance to overwrite the file.
  51.  
  52.    "Colors" menu item or RightAmiga+W or W key - Switches  the  palette
  53. between the original Colors and different sets. Total  eight  colorsets
  54. are available,simulating different monitor shades - Black&White (Grey),
  55. Red, Green, Blue, Yellow, Magenta, Cyan and Color (default palette).The
  56. selected palette is taken into account during saving.
  57.  
  58.    "Mode" menu item or RightAmiga+C or C key - Switches between MODE 4
  59. and MODE 8.
  60.  
  61.    "Quit" menu item or RightAmiga+Q or Esc key - Quits the program.
  62.  
  63.  
  64. The full source code of the utility is available in the source drawer.
  65. Entirely coded in C, compiles with the freeware VBCC compiler and with
  66. SAS_C and GCC as well.
  67.  
  68.  ENJOY
  69.  
  70.  
  71. Legal Issues
  72.  
  73.   This software can be freely copied, as long as it remains in its
  74. original form, and the archive is intact.
  75.  
  76.   `QLView' is provided  "AS-IS"  without any warranties. Although I did
  77. my best for it being bug free,  there  still might be some hidden ones,
  78. of which I am not yet aware. That's  why I am  NOT  responsible for any
  79. damages caused by this software. 
  80.  
  81. PeaceFestival_Mode8 is a picture of the Sambassadors of Groove, a local
  82. Samba band taken on Kodak DC200+, read from the camera with  SuperBASIC
  83. DIGICAM_BAS program and rendered and dithered from  JPEG  to  MODE 8 by
  84. Dave's PHOTON program - all on Qdos (and mostly Amiga Qdos).
  85.  
  86. goodie2_screen is an example image from QL Quick Mandelbrot, written by
  87. Kenneth Murray, published by CGH Services in 1991.
  88.  
  89. Acknowledgements:
  90.  
  91.   PeaceFestival_Mode8, EandI_MODE4, ArcEd_Russian_screen and
  92. goodie2_screen provided by Simon N Goodwin.
  93.   SAS_C and GCC updated and bugfixes by Stefan A. Haubenthal.
  94.  
  95. About the Sinclair QL:
  96.  
  97.   The Sinclair QL - stands for Quantum Leap is  believed to be the first
  98. computer available with preemptive multitasking operation system. It was
  99. originally released in  1984  as successor of the legendary Sinclair  ZX
  100. Spectrum series,  but it failed to gain popularity. For more information
  101. check the QDOS emulator, available on Aminet. 
  102.  
  103.  
  104. New in version 25.08:
  105.  
  106.  Added automatic mode selection.
  107.  Speed enhancements in the render code. 
  108.  
  109. New in version 25.07:
  110.  
  111.  Added MorphOS native port.
  112.  Updated to compile under GCC.
  113.  Removed the need of -lauto switch for VBCC.
  114.  Replaced the menuvalues with #define constants.
  115.  Minor changes in the source code for better read. 
  116.